home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / t_bsd / 386bsd.txt < prev    next >
Text File  |  1996-06-25  |  61KB  |  1,710 lines
  1.  
  2.  
  3.  
  4.  
  5. July 1992                    Release 0.1
  6.  
  7.  
  8.             Installation Notes
  9.                 for
  10.              386BSD Release 0.1
  11.  
  12.                William Jolitz
  13.             Lynne Jolitz
  14.  
  15.  
  16. 386BSD Release 0.1:
  17.  
  18.      Welcome to 386BSD Release 0.1, the    second    edition  of
  19. the  386BSD  operating    system    created by William and Lynne
  20. Jolitz. Like its predecessor, 386BSD  Release  0.0,  Release
  21. 0.1  comprises    an  entire  and complete UNIX-like operating
  22. system for the 80386/80486-based AT Personal Computer.
  23.  
  24.      386BSD Release 0.1 is an enhanced version of the origi-
  25. nal  release  done  by    William    F. Jolitz, the developer of
  26. 386BSD. 386BSD Release    0.0  was  based    on  the  Networking
  27. Software,  Release  2  from  the University of California at
  28. Berkeley EECS Department, and included much  of    the  386BSD
  29. work  done  earlier  by    Bill  and  contributed by us to the
  30. University.  The latest release, 386BSD    Release  0.1,    con-
  31. tains  new  work  by  the developer and many new items which
  32. have been freely contributed by    other    software  developers
  33. for  incorporation  into 386BSD (see the file CONTRIB.LIST).
  34. These contributions have  increased  the  functionality    and
  35. made  it more robust. As a courtesy to the developer and the
  36. many people who have generously contributed  these  software
  37. enhancements,  we  request  that users abide by and properly
  38. maintain all attributions, copyrights,    and  copylefts    con-
  39. tained within this release.
  40.  
  41.      386BSD is intended to foster new research and  develop-
  42. ment  in operating systems and networking technology by pro-
  43. viding this base technology in a broadly accessible  manner.
  44. As  such, like its predecessor, 386BSD Release 0.1 is freely
  45. redistributable and modifiable.
  46.  
  47. Features of 386BSD Release 0.1
  48.  
  49.      386BSD Release 0.1 is intended to    be  widely  used  by
  50. those  interested in "pushing the envelope" towards the for-
  51. mation and development of innovative ideas in computer tech-
  52. nology.    As such, we have spent considerable time developing
  53. a system which    is  simple  to    partition  and    install    and
  54. emphasizes stability and completeness.
  55.  
  56.      The objective  of    this  release  is  to  allow  anyone
  57. interested to quickly obtain and install 386BSD, so that the
  58. time is spent using the system    and  not  on  arcane  system
  59. administrative details.
  60.  
  61.  
  62. 386BSD INSTALLATION NOTES    1    Copyright (C) 1992 TeleMuse
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. July 1992                    Release 0.1
  71.  
  72.  
  73.      Among the many new features of 386BSD:
  74.  
  75. *    New "Tiny 386BSD" System Installation Floppy
  76.  
  77. *    Simplified installation procedures.
  78.  
  79. *    386BSD partitioning for use on an MS-DOS system.
  80.  
  81. *    Compressed,    multivolume    CPIO     dump     format
  82.      binary/source/other  distribution    sets on MS-DOS flop-
  83.      pies.
  84.  
  85. *    387 emulation.
  86.  
  87. *    SCSI support.
  88.  
  89. *    CD-ROM support.
  90.  
  91. *    NFS, TCP/IP and full networking.
  92.  
  93. *    New 386BSD "Fix-It" System Maintenance Floppy.
  94.  
  95. *    New "Additional User Software" MS-DOS floppy dump.
  96.  
  97. We hope that while you browse through  386BSD  Release    0.1,
  98. you  will  take a moment to look at the CONTRIB.LIST file to
  99. see the many people who have made this release possible.
  100.  
  101. 386BSD Documentation and Sources of Information
  102.  
  103.      386BSD is intended for  research,    development,  educa-
  104. tion,  and just plain exploration. Source, Binary, Installa-
  105. tion, and Fix-It floppies are available at a large number of
  106. sites.    There are many user groups, support groups, computer
  107. societies and individuals  who    are  supplying    and  running
  108. 386BSD and they are good sources of information and support.
  109.  
  110.      Installation procedures,  release-specific    items,    and
  111. simple    trouble-shooting are contained in the following sec-
  112. tions.
  113.  
  114.      For users who wish to understand the internals  of    the
  115. 386BSD    system    developed  by William F. Jolitz from 1989 to
  116. the present, the most immediate and available  reference  is
  117. our  feature  series  entitled    "Porting  UNIX    to the 386",
  118. appearing in Dr. Dobbs Journal, USA (January  1991  to    July
  119. 1992) and UNIX Magazine, Germany (June 1991 to present). For
  120. inquiries on the article series (including  reprints),    con-
  121. tact the magazines for information.
  122.  
  123.      A book discussing the  internals  of  386BSD,  entitled
  124. 386BSD From the Inside-Out, will be available late 1992.
  125.  
  126.  
  127. 386BSD INSTALLATION NOTES    2    Copyright (C) 1992 TeleMuse
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. July 1992                    Release 0.1
  136.  
  137.  
  138.      For  information  and  questions  on  386BSD  seminars,
  139. tutorials, and materials, contact:
  140.  
  141.     Jim Joyce
  142.     The Gawain Group
  143.     139 Noe Street
  144.     San Francisco, California 94114 USA
  145.     1-415-626-7581
  146.  
  147.  
  148.      In the meantime, we can recommend some other  books  on
  149. the UNIX system that we have found useful.
  150.  
  151. 1.   For a good general presentation on UNIX system  design,
  152.      we    recommend  Maurice J. Bach's The Design of the UNIX
  153.      Operating System (Prentice-Hall Software Series,  1986,
  154.      471pp).   Although it is now obsolete in some areas, it
  155.      still provides the best discussion of key system  areas
  156.      such as the buffer cache.
  157.  
  158. 2.   For a more theoretical viewpoint of  operating  systems
  159.      design, we suggest Per Brinch Hansen's Operating System
  160.      Principles (Prentice-Hall Series in Automatic  Computa-
  161.      tion, 1973, 366pp).
  162.  
  163. 3.   For an understanding of  the  roots  of  all  UNIX-like
  164.      operating    systems,   one    should  obtain  Elliot  I.
  165.      Organick's The Multics System: An    Examination  of    Its
  166.      Structure (MIT Press, 1972, 392 pp).
  167.  
  168. 4.   Of course, every serious student  of  computer  science
  169.      should  have Donald E. Knuth's three-volume set The Art
  170.      of Computer Programming (Addison-Wesley Series in    Com-
  171.      puter Science and Information Processing, 1975).
  172.  
  173. 5.   The UNIX Time-Sharing System by  D.M.  Ritchie  and  K.
  174.      Thompson,    Communications    of  the ACM, 17, No. 7 (July
  175.      1974). This is the classic paper  on  the    UNIX  system
  176.      which  (we    feel) set the tone for all future work with
  177.      UNIX-like systems:
  178.  
  179.      The success of UNIX lies not so much in new in-
  180.      ventions but rather in the full exploitation of
  181.      a carefully selected set of fertile ideas,  and
  182.      especially  in showing that they can be keys to
  183.      the implementation  of    a  small  yet    powerful
  184.      operating system
  185.  
  186.  
  187. 6.   On the 386-side, it's best to go to  the  source,    with
  188.      John  H.  Crawford and Patrick P. Gelsinger's book Pro-
  189.      gramming the 80386 (Sybex, 1987, 773pp). There are many
  190.      other 386/486 books available as well.
  191.  
  192.  
  193. 386BSD INSTALLATION NOTES    3    Copyright (C) 1992 TeleMuse
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. July 1992                    Release 0.1
  202.  
  203.  
  204.      For general information on    how-to-use  UNIX-like    sys-
  205. tems, C++, GNU software, and so forth, there are a number of
  206. good books available from any technical bookstore, with more
  207. arriving daily.    In addition, an on-line manual is available
  208. (in the    binary    distribution  set).  It  contains  specific
  209. information  on the use of UNIX utilities and commands. Type
  210. "man man" for information on the online manual.
  211.  
  212.      There are many newsgroups forming which discuss 386BSD.
  213. One  should  check  out M&T Online (the DDJ newsgroup), Com-
  214. puserve, and BIX for 386BSD discussion forums.
  215.  
  216.      On the INTERNET/USENET, we are hoping to establish    our
  217. own  newsgroup called "comp.os.386bsd". This newsgroup would
  218. reside    alongside  the    "comp.os.mach"    and  "comp.os.linux"
  219. newsgroups. Already there are over 100,000 copies of Release
  220. 0.0, and we hope to add to this    number    with  the  new    and
  221. improved  Release  0.1.    Please  help    us to establish this
  222. newsgroup devoted to the "freely available"  386BSD  system,
  223. by  asking  your  news coordinator to subscribe to it. We do
  224. not recommend using comp.unix.bsd, since 386BSD, like  linux
  225. and mach, is not a "comp.unix" system.
  226.  
  227.      There are a number of 386BSD  special  interest  groups
  228. forming,  including  those  interested    in discussing shared
  229. libraries, filesystems, networking, windowing systems, giga-
  230. bit networking, and so forth. Also, a number of projects are
  231. getting underway focussing on improvements in the kernel and
  232. utilities.   If    you are interested in learning about any of
  233. these groups, please fill out and send in  the    REGISTRATION
  234. form and we will put you on the SIG mailing list (along with
  235. the general 386BSD mailing list).
  236.  
  237.      We    can  be  contacted  via   Compuserve    email    (CIS
  238. 76703,4266  or 76703.4266@compuserve.com), BIX (wjolitz), or
  239. via the internet at ljolitz@cardio.ucsf.edu, and through DDJ
  240. and UNIX Magazin (Europe). Please be patient with responses,
  241. as the 386BSD user group base is growing  daily,  and  some-
  242. times  responses  are  a bit delayed. However, we do want to
  243. hear from you.
  244.  
  245. 386BSD Release 0.1 Contents:
  246.  
  247.      386BSD Release 0.1 consists of:
  248.  
  249. Tiny 386BSD: System Installation Floppy
  250.      Tiny 386BSD is a  single  floppy  386BSD  system  on  a
  251.      high-density  diskette. This completely standalone sys-
  252.      tem manages to allow a potential 386/486 based PC to be
  253.      qualified    for use with 386BSD, simply by attempting to
  254.      boot it as an ordinary floppy. It also can be  used  to
  255.      simply  partition, install, and load 386BSD on the hard
  256.      disk. It contains complete installation information and
  257.  
  258.  
  259. 386BSD INSTALLATION NOTES    4    Copyright (C) 1992 TeleMuse
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267. July 1992                    Release 0.1
  268.  
  269.  
  270.      networking    facilities  for  obtaining  the release via
  271.      floppies, tape, CD-ROM, SLIP, and Ethernet.
  272.  
  273.      You can obtain the latest labeled copy of    Tiny  386BSD
  274.      directly from DDJ as part of their Careware Program. To
  275.      obtain one from DDJ, just send a  1.2  MByte  formatted
  276.      and   error-free  high-density  diskette  and  a  self-
  277.      addressed stamped diskette mailer to: Tiny 386BSD,    Dr.
  278.      Dobbs  Journal,  411 Borel Avenue, San Mateo, CA. 94402
  279.      USA and they will send you the latest copy with a great
  280.      label.  There  is    no  charge  for this service, but it
  281.      would be great if you slip a dollar  or  two  into    the
  282.      mailer  for  the  kids helped by the Children's Support
  283.      League of the East Bay as part of DDJ's Careware  char-
  284.      ity  drive.  We  know  the children will appreciate it.
  285.      (See the CAREWARE.INFO file for more information on the
  286.      Careware Program and the Children's Support League.)
  287.  
  288. Binary Distribution
  289.      A collection of high-density MS-DOS  floppy  disks    (10
  290.      3.5-inch  floppies    or  12 5.25-inch floppies), also in
  291.      compressed multi-volume CPIO form, containing the    exe-
  292.      cutable,  data,  and  documentation  files of a working
  293.      386BSD  system,  including    C  and    C++  compilers    and
  294.      libraries.    When    extracted, the files occupy approxi-
  295.      mately 30 MBytes of disk space. Note that    at  least  5
  296.      MBytes  of    swap  space,  plus  an operating reserve of
  297.      another 10% of the total accumulated  disk    space    men-
  298.      tioned  should be considered as minimum to operate this
  299.      system.  An additional 14 MBytes is necessary  to    hold
  300.      the  distribution    prior  to  extraction.    While 386BSD
  301.      does not require MS-DOS for operation, MS-DOS  floppies
  302.      are used to simplify distribution of the release.
  303.  
  304. Source Distribution
  305.      A collection of high-density MS-DOS  floppy  disks    (11
  306.      3.5-inch floppies or 13 5.25-inch floppies), which is a
  307.      multi-volume compressed  CPIO  format  archive  of    the
  308.      source  language  files with which to recreate the sys-
  309.      tem.  When extracted, the files  consume  approximately
  310.      37    MBytes of space. In addition, at least 25 MBytes of
  311.      space is taken up by  the    binary    files  created    when
  312.      recompiling.   Please note that an additional 20 MBytes
  313.      is necessary to hold the  interim    distribution  to  be
  314.      loaded  prior  to    release    extraction.   As  mentioned
  315.      above, 386BSD does not require MS-DOS for operation  --
  316.      MS-DOS  floppies  are  used to simplify distribution of
  317.      the release.
  318.  
  319. Additional User Software Distribution
  320.      A collection of high-density  MSDOS  floppy  disks    (17
  321.      3.5-inch  floppies    or 20 5.25-inch floppies), again in
  322.      compressed multi-volume CPIO format, containing various
  323.  
  324.  
  325. 386BSD INSTALLATION NOTES    5    Copyright (C) 1992 TeleMuse
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333. July 1992                    Release 0.1
  334.  
  335.  
  336.      public software packages that have been integrated into
  337.      386BSD, and are present both in source  and  binary  in
  338.      this  distribution    set. When extracted, the files con-
  339.      sume approximately 51 MBytes  of  space.  In  addition,
  340.      other files not necessary for system operation but con-
  341.      venient for use with the system  are  present  in    this
  342.      set.  This distribution set is the fastest growing por-
  343.      tion of 386BSD, and represents a considerable amount of
  344.      work done by many dedicated contributors to 386BSD.
  345.  
  346. 386BSD Fix-It System Maintenance Floppy
  347.      This single high-density floppy contains the standalone
  348.      system and the utilities required to diagnose, fix, and
  349.      return to operation the  system  running  on  the    hard
  350.      disk.  This floppy can also be used by experienced sys-
  351.      tem administrators to manually  partition    and  install
  352.      386BSD Release 0.1.
  353.  
  354.      A variety of online information notes regarding  386BSD
  355. is   available    and  can  be  examined    at  any    time.    The
  356. INSTALL.NOTES file (this file) contains installation  infor-
  357. mation.    The  REGISTRATION  file  contains  the 386BSD user
  358. group registration form.  Please complete and return  it  to
  359. receive    updates  and  mailings    about    386BSD.    The list of
  360. major 386BSD contributors is contained in  the    CONTRIB.LIST
  361. file.  The  CAREWARE.INFO  file    in the base system contains
  362. information on the DDJ Careware    program  and  Tiny  386BSD.
  363. The  COPYRIGHT file contains the 386BSD copyright and condi-
  364. tions for use. In addition, complete checksum MANIFESTS    for
  365. each category are also included.
  366.  
  367.      Software bugs and fixes should be    reported  using    the
  368. BUGNFIX.FORM.    Software  contributors    should    refer to the
  369. SOFTWARE.FORM for information on how to contribute  software
  370. for inclusion in future 386BSD releases.
  371.  
  372.      All distributions can be downloaded onto floppies.    The
  373. Tiny  386BSD  installation  floppy should be obtained first,
  374. via a friend, DDJ, or by  using    kermit    to  snag  the    file
  375. dist.fs (a binary image 1.2 MByte floppy for either 3.5-inch
  376. or 5.25-inch high-density  diskettes)  and  rawrite.exe    (an
  377. MS-DOS    utility    to  write  the    image    on  the high-density
  378. floppy). You can also use rawrite.exe to  write    the  Fix-It
  379. floppy    to  a  high-density  floppy.  The  distribution sets
  380. (binary, source, additional software) are already set up for
  381. high-density  MS-DOS  floppies,    and should not be used with
  382. rawrite.exe.
  383.  
  384. Manifests
  385.  
  386.      The manifest files are extremely important to  validate
  387. file and system integrity.  These manifest files contain the
  388. checksum of every 386BSD file.    Each file  should  have    the
  389.  
  390.  
  391. 386BSD INSTALLATION NOTES    6    Copyright (C) 1992 TeleMuse
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399. July 1992                    Release 0.1
  400.  
  401.  
  402. same checksum number as listed in the manifest. If a file is
  403. corrupted or altered, the checksum number will not match the
  404. checksum  number  recorded  in the manifest. If there is any
  405. difference whatsoever, or you suspect that a file and/or the
  406. manifest  on a machine has been altered or corrupted, cross-
  407. check any discrepancies    with  the  standard  manifests    and
  408. files on Compuserve for confirmation.  DO NOT USE ANY 386BSD
  409. SOFTWARE WHICH DOES NOT CHECKSUM CORRECTLY WITH THE STANDARD
  410. MANIFESTS AND FILES.
  411.  
  412.      386BSD should only be obtained from sites which provide
  413. the  complete  system  as distributed. Incomplete or partial
  414. versions of 386BSD (such as source sans binary and  documen-
  415. tation)    are not recommended, since they cannot be satisfac-
  416. torily correlated with system  checksum    manifests  to    com-
  417. pletely    validate  file and system integrity.  OBTAIN 386BSD
  418. ONLY FROM SITES    WHICH    OFFER  THE  COMPLETE  AND  VALIDATED
  419. BINARY,    SOURCE,  INSTALLATION FLOPPY AND ON-LINE DOCUMENTA-
  420. TION.
  421.  
  422.      If you find corrupted and/or altered  386BSD  software,
  423. or  incomplete    or inaccurate representations of this system
  424. on a ftp or BBS site, please snapshot a copy for later exam-
  425. ination, notify the Sysop, send email to our address at Com-
  426. puserve, and use only the  files  on  Compuserve  until    the
  427. problem is corrected.
  428.  
  429.      We    do  not  recommend  that  any    386BSD    software  be
  430. obtained off of UUNET.
  431.  
  432. Scope and Goals of 386BSD Releases:
  433.  
  434.      386BSD Release 0.0 was made available via    the  network
  435. in  March  of  1992, and the response was overwhelming -- an
  436. estimated 100,000 copies were obtained by users in one month
  437. through    the  "grassroots" efforts of a large number of peo-
  438. ple.  Dedicated network volunteers got it  out    to  as    many
  439. people    as  desired  it.  Systems  programmers    and software
  440. enthusiasts got it running on a variety of PC's    and  confi-
  441. gurations,  and spent time and energy aiding others via user
  442. group meetings, postings and email. Finally, a large  number
  443. of  software  contributions were made available for the next
  444. release.
  445.  
  446.      After four years of work,    386BSD    finally    became    the
  447. generic research and educational platform we envisioned when
  448. we wrote "386BSD: A Modest Proposal", the software  specifi-
  449. cation    for  386BSD,  back  in    mid-1989.  Better still, our
  450. goals for doing 386BSD Release 0.0 were accomplished. 386BSD
  451. Release    0.0  was  a  minimalist  version which demonstrated
  452. feasibility, provided accessibility, and assured our readers
  453. and  supporters    that  this  project  would  be finished and
  454. available to all,  and    not  just  appropriated    by  private
  455.  
  456.  
  457. 386BSD INSTALLATION NOTES    7    Copyright (C) 1992 TeleMuse
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465. July 1992                    Release 0.1
  466.  
  467.  
  468. concerns.
  469.  
  470.      386BSD Release 0.1, in the    tradition  of    odd-numbered
  471. releases,  is  essentially  a  new-and-improved    version  of
  472. Release 0.0.  It is far more robust  and  well-rounded    than
  473. Release    0.0  and  supports more functionality, such as SCSI
  474. support and 387 emulation. In sum, 386BSD Release 0.1 is now
  475. a comfortable system for those used to working with Berkeley
  476. UNIX.    While  386BSD  still  contains    some    experimental
  477. software,  it is satisfactory for the experienced programmer
  478. or dedicated student.
  479.  
  480. Devices Supported in this Release:
  481.  
  482.      This release supports a 386/486 SX/DX ISA (ATBUS)    sys-
  483. tem,  with  the    traditional hard and floppy disk controller
  484. (MFM, ESDI, IDE, SCSI - Adaptec 1542, RLL).  Also, the usual
  485. display adapters (MDA/CGA/VGA/HGC) are supported, along with
  486. the serial communications ports (COM1 and COM2) and parallel
  487. port  (LPT1). Ethernet controllers supported are the Western
  488. Digital/SMC 8000/Elite series,    Novell    NE1000/NE2000,    3COM
  489. 3C503,    and  the ISOLAN ISOLINK.  Clones also appear to work
  490. quite well.  Tape drive support is available for QIC-02    and
  491. SCSI  (Adaptec 1542) controllers as well, allowing use of 3M
  492. cartridges of QIC-60 through QIC-150 format  (no  QIC-40  or
  493. QIC-80    supported  at this time). SCSI (Adaptec 1542) CD-ROM
  494. drives and CD-ROM ISO 9660 filesystem format  is  also    sup-
  495. ported.    The system supports either 287 or 387 coprocessor,
  496. but does not require one for operation.
  497.  
  498.      As configured on the binary  distribution,    the  system
  499. minimally  requires  a hard disk and controller, floppy disk
  500. drive (either 5.25 or 3.5 high-density    only),    and  display
  501. adapter.  If  the  serial port or a Western Digital Ethernet
  502. card (port 0x280, IRQ 2, iomem 0xd000) is present, the    sys-
  503. tem  can make use of it as well. (See TABLE 1 for configura-
  504. tion information for adaptec scsi controller, serial  ports,
  505. ethernet controllers and QIC-02).
  506.  
  507.      It is recommended that the system possess    at  least  2
  508. MBytes    of  memory,  but  more    is definitely preferred. A 4
  509. MByte RAM system with a 200 MByte plus SCSI hard disk  is  a
  510. comfortable  configuration,  although by sharing the sources
  511. via NFS, networked systems with 40 MByte  drives  are  quite
  512. useful.
  513.  
  514. A Tour through the Tiny 386BSD Installation Floppy
  515.  
  516.      The Tiny 386BSD Installation floppy contains a complete
  517. 386BSD    kernel    with  drivers  and  networking facilities to
  518. allow 386BSD to run on a broad number of  PC  platforms    and
  519. facilitate  loading of the rest of the system. By the clever
  520. use of space-saving techniques, approximately 1.6 MBytes  of
  521.  
  522.  
  523. 386BSD INSTALLATION NOTES    8    Copyright (C) 1992 TeleMuse
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531. July 1992                    Release 0.1
  532.  
  533.  
  534.  
  535. ____________________________________________________________
  536.  
  537. Adaptec 1542 SCSI Controller Configuration Information:
  538.     as0    at isa? port 0x330 bio irq 11 drq 5 vector asintr
  539.  
  540. Serial Port Configuration Information:
  541.     com1    at isa? port "IO_COM1" tty irq 4 vector comintr
  542.     com2    at isa? port "IO_COM2" tty irq 3 vector comintr
  543.  
  544. Ethernet Controller Configuration Information:
  545.  
  546. Western Digital/SMC 8000/Elite series:
  547.     we0 at isa? port 0x280 net irq 2 iomem 0xd0000 iosiz 8192 vector weintr
  548. Novell NE1000/NE2000:
  549.     ne0 at isa? port 0x300 net irq 2 vector neintr
  550. 3COM 3C503:
  551.     ec0 at isa? port 0x250 net irq 2 iomem 0xd8000 iosiz 8192 vector ecintr
  552. ISOLAN ISOLINK:
  553.     is0 at isa? port 0x280 net irq 10 drq 7 vector isintr
  554.  
  555. QIC-02 Configuration Information:
  556.     wt0    at isa? port 0x300 bio irq 5 drq 1 vector wtintr
  557. ____________________________________________________________
  558.  
  559. TABLE 1: Device Configuration Information
  560. ____________________________________________________________
  561.  
  562.  
  563. software are contained on a 1.2 MByte floppy.
  564.  
  565.      The 386BSD kernel itself is only 400 KBytes --  consid-
  566. erably smaller than commercial UNIX-like system kernels with
  567. comparable abilities, yet it is a complete  POSIX-compatible
  568. system    with  Internet    protocols,  NFS    and  multiple other
  569. filesystems, and numerous device drivers.
  570.  
  571.      The  Tiny    386BSD    floppy    can  be    explored  prior  to
  572. proceeding  with  any  further steps. You can insert it into
  573. any 386/486 AT PC and try to boot  it  up.  (The  floppy  is
  574. read-only  until the install procedure is actually run). You
  575. can then explore this mini-386BSD system at your  own  pace,
  576. by  looking  at    files and running commands such as ls, pwd,
  577. and cd.
  578.  
  579.      If you decide you would rather run Tiny 386BSD off of a
  580. fast hard disk instead of a slow floppy, you can setup a new
  581. partition (using the MS-DOS fdisk command) and    install    the
  582. base  system at any time. (You can also easily deinstall the
  583. base system by simply deleting the partition).
  584.  
  585.      Tiny 386BSD contains automated facilities    to  qualify,
  586. partition,  install,  download,    and extract the rest of the
  587.  
  588.  
  589. 386BSD INSTALLATION NOTES    9    Copyright (C) 1992 TeleMuse
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597. July 1992                    Release 0.1
  598.  
  599.  
  600. system easily.    Among the downloading  facilities  supported
  601. on  Tiny 386BSD are via Ethernet, slip, modems, CD-ROM (SCSI
  602. only), QIC-02 and SCSI interface tape,    and  floppies.    The
  603. downloading  facilities    have  been compressed to save space
  604. and are uncompressed upon installation of  the    base  system
  605. onto the hard disk.
  606.  
  607.      Tiny 386BSD has squeezed onto it a remarkable number of
  608. items, but due to space limitations, it contains only a very
  609. tiny fraction of what appears in  386BSD  Release  0.1.    The
  610. real  386BSD  release is a complete development environment.
  611. You can do real OOP, leverage the software  control  manage-
  612. ment  (RCS) utilities, use a plethera of editors, compilers,
  613. and huge number of utilities and related facilities, includ-
  614. ing  networking -- and this doesn't even include the popular
  615. publicly available packages that have been ported by others.
  616. We cannot emphasize enough how much 386BSD actually contains
  617. -- and it is still growing!
  618.  
  619.      Finally, in addition to the binary, you can also obtain
  620. the  publicly-available    source code to work on areas which,
  621. until  recently,  required  a  working    association  with  a
  622. research  facility.  386BSD  groups  are  working  on shared
  623. libraries,   windowing    systems,   high-speed    networking,
  624. filesystems,  operating    systems  --  and  a whole lot more.
  625. Everyone with a good idea can become a part of this process.
  626.  
  627. Booting Up Tiny 386BSD
  628.  
  629.      To boot up Tiny 386BSD, simply insert it in the  floppy
  630. drive and type "CNTL/ALT/DEL". Be patient -- it takes a lit-
  631. tle time (approximately 1.5 minutes). Finally, a banner mes-
  632. sage should appear:
  633.  
  634.     386BSD Release 0.1 by William and Lynne Jolitz.
  635.     Copyright (c) 1989,1990,1991,1992 William F. Jolitz. All rights reserved.
  636.     Based in part on work by the 386BSD User Community and the
  637.     BSD Networking Software, Release 2 from UCB EECS Department.
  638.  
  639.  
  640. After this banner message, the devices that the system finds
  641. are listed: terminal devices, mass storage devices, and net-
  642. work devices.
  643.  
  644.      After the monitor and serial port are found,  the    next
  645. devices    discovered  should  be    the  disk controller(s) (AT
  646. and/or Adaptec SCSI controllers).  Then    the  system  should
  647. attempt    to  locate  (if  present) any Ethernet controllers,
  648. floppy drives (1.2 MByte indicates a 5.25-inch floppy  drive
  649. and   1.44   MByte   indicates    a  3.5-inch  floppy  drive),
  650. floating-point coprocessor, and QIC-02 (wt0) drive.
  651.  
  652.  
  653.  
  654. 386BSD INSTALLATION NOTES    10    Copyright (C) 1992 TeleMuse
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662. July 1992                    Release 0.1
  663.  
  664.  
  665.      After it finds these  devices  (if    present),  it    then
  666. probes for the hard disk(s). However, if the geometry of the
  667. drive has not yet been installed (via the install or diskla-
  668. bel command), it will state "wd0 (or as0): cannot find label
  669. (no disk label)". (If this message is absent, no  drive    was
  670. found.    In  this  case,  the  drive  connections  should be
  671. rechecked).
  672.  
  673.      When the "#" prompt  appears,  you    are  now  ready  to
  674. explore    Tiny  386BSD.    (To install the base system, consult
  675. the "Installation Procedures" further on in these notes).
  676.  
  677.      If any devices in the machine are    not  found,  the  PC
  678. should    be  examined  for  proper  cabling  and jumpering of
  679. drives.    You should also check to make sure that the devices
  680. not  found  are    ones  which are actually documented here as
  681. supported on 386BSD systems. In the case  of  Ethernet    con-
  682. trollers,  the    default case (using IRQ3) cannot be used. To
  683. use the controllers, they must be rejumpered (old boards) or
  684. reconfigured  (using  software supplied by the manufacturer)
  685. to use IRQ2 8-bit (translated to IRQ9 16-bit on the ISA    bus
  686. and  system  software).    See  Table  1 in the "Devices Sup-
  687. ported" section for further information.
  688.  
  689. Elements of Tiny 386BSD
  690.  
  691.      Before embarking on  the  installation  procedures,  it
  692. helps  to  understand  how  the    Tiny  386BSD floppy is put-
  693. together.  Basically, Tiny  386BSD  contains  the  following
  694. major elements:
  695.  
  696. 1.   The operational 386BSD kernel itself,  with  networking
  697.      and driver support.
  698.  
  699. 2.   The documentation    files  discussing  installation    and
  700.      registration.   Also,  manifests,    copyright, and other
  701.      relevant items.
  702.  
  703. 3.   The device interfaces to the drivers (console, wd,    as,
  704.      etc.)
  705.  
  706. 4    The install command, which facilitates automatic  crea-
  707.      tion  of  a 386BSD partition (if desired) and installa-
  708.      tion of the base system onto the hard  disk.   It    also
  709.      places  on the disk the facilities for loading the rest
  710.      of the system on the disk.
  711.  
  712. 5.   Facilities for loading the rest of the  system  on    the
  713.      disk,  via    floppy,  tape, networks or Compuserve (BBS)
  714.      download (compressed).
  715.  
  716. 6.   The extract command, used with the base system  on    the
  717.      hard  disk    once Tiny 386BSD has been installed, checks
  718.  
  719.  
  720. 386BSD INSTALLATION NOTES    11    Copyright (C) 1992 TeleMuse
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728. July 1992                    Release 0.1
  729.  
  730.  
  731.      for the presence and correctness of all elements of the
  732.      386BSD   system  distribution  (informing    you  of    any
  733.      discrepancies).  If there are no discrepancies, it con-
  734.      tinues  and  extracts the distribution and places it on
  735.      the hard disk.
  736.  
  737. Files of Tiny 386BSD
  738.  
  739.      Tiny 386BSD contains the following key files:
  740.  
  741. /        The main or "root" directory.    386BSD    (the
  742.         kernel    itself),  documentation    files,    and
  743.         other directories  are    located    here.    The
  744.         install    utility,  used    only for installing
  745.         the base  system  on  the  hard    disk,    also
  746.         resides here.
  747.  
  748. /bin        stty sets the  characteristics    of  the    the
  749.         console,  baud    rates  for serial ports, and
  750.         other parameters.  sh is the  shell  command
  751.         processor.  Among  the shell commands avail-
  752.         able are the often used    set,  (set  charac-
  753.         teristics) echo, (obvious) pwd, (print work-
  754.         ing directory and cd (change directory).  ls
  755.         lists the files in a directory.
  756.  
  757. /dev        Device interface files for all devices.
  758.  
  759. /etc        baselist.Z is a compressed file containing a
  760.         list  of the files copied onto the hard disk
  761.         by install.  To view this list, type:
  762.  
  763.             zmore baselist.Z
  764.  
  765.         baseutils.cpio.Z is a compressed  file    con-
  766.         taining all the necessary downloading facil-
  767.         ities  used  after  the    base    system    is
  768.         installed  on the hard disk.  profile is the
  769.         master    configuration  file  for  the  shell
  770.         (loaded before all others). In this case, it
  771.         is used to specify the patch level  of    this
  772.         floppy, and is consulted by all related pro-
  773.         grams.
  774.  
  775. /mnt        Directory used to mount devices as files.
  776.  
  777. /sbin        init, the very first process run, is used to
  778.         bootstrap  the system after 386BSD is loaded
  779.         and run.  newfs is used by install to do the
  780.         high-level formatting of the disk drive.
  781.  
  782. /usr/bin    More utilities relating to loading the    dis-
  783.         tribution.     The    distribution   is    in
  784.  
  785.  
  786. 386BSD INSTALLATION NOTES    12    Copyright (C) 1992 TeleMuse
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794. July 1992                    Release 0.1
  795.  
  796.  
  797.         multivolume compressed CPIO format.  cpio is
  798.         the  AT&T  archive  command,  contributed to
  799.         BSD, and consolidates the files of the    dis-
  800.         tribution  (in    CPIO  format).    The compress
  801.         utilities: zcat,  compress,  and  uncompress
  802.         are   based   on   the    modified  Lempel-Ziv
  803.         compression algorithm. They reduce the    size
  804.         and  hence  the    transfer or loading time of
  805.         the distribution.  more filename allows    one
  806.         to view a pagenated file.
  807.  
  808. /usr/distbin    This directory contains most of the commands
  809.         for  "doing"  things.    The mount and umount
  810.         commands gain and terminate access  to    dev-
  811.         ices as filesystems, for example
  812.  
  813.             mount /dev/wd01 /mnt
  814.  
  815.         (used  by  the    install    command).  Mounting
  816.         filestructures    correspond to accessing "A:,
  817.         ..." device directories    in  MS-DOS.  386BSD
  818.         always    operates  relative  to the device on
  819.         which it operates.  Therefor,  if  currently
  820.         operating off the hard disk, one must type
  821.  
  822.             mount /dev/fd0a /mnt
  823.             ls /mnt
  824.             umount /mnt
  825.  
  826.         to list files on a floppy  and    then  remove
  827.         the  association.  The    -i  option  of mount
  828.         allows mounting of a CD-ROM device via SCSI.
  829.         The  -u option turns the default "read-only"
  830.         root  filesystem  to  "read-write".   386BSD
  831.         improves  filesystem  access  over MS-DOS by
  832.         caching writes until necessary. The shutdown
  833.         command    (with    no  arguments) cleanly shuts
  834.         down the system,  so  that  the    PC  can  be
  835.         turned off without incident.  The command
  836.  
  837.             shutdown -todos
  838.  
  839.         will cleanly shutdown 386BSD  and  make    the
  840.         MS-DOS    partition  "active".  After shutdown
  841.         completes,  wait  for  a  prompt  to  hit  a
  842.         return, and then the PC will boot up MS-DOS.
  843.         To return from MS-DOS to 386BSD, simply    run
  844.         fdisk  to make the 386BSD partition "active"
  845.         and reset. Optionally, one can also make the
  846.         386BSD    partition  active  by  rebooting the
  847.         Tiny 386BSD floppy and typing:
  848.  
  849.             shutdown -to386bsd
  850.  
  851.  
  852. 386BSD INSTALLATION NOTES    13    Copyright (C) 1992 TeleMuse
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860. July 1992                    Release 0.1
  861.  
  862.  
  863.         removing the floppy, and hitting a return.
  864.  
  865.         Other typical utilities (reduced due to size
  866.         constraints)   include:    mkdir    (creates  a
  867.         directory, i.e.    mkdir    directoryname),  rm
  868.         (deletes  a  file,  i.e.   rm  filename), mv
  869.         (moves a file to a new location    or  renames
  870.         it,  i.e.   mv    oldfilename newfilename), cp
  871.         (replicates  a    file,  i.e.   cp   filename1
  872.         filename2),  and  cat  (catenate  files, cat
  873.         file1 file2 ..., or view a file, cat file).
  874.  
  875. /usr/mdec    Bootstraps    for    386BSD    (SCSI    or
  876.         AT/IDE/ESDI/MFM/RLL  devices).    The initial
  877.         block bootstraps (asboot,  wdboot)  and    the
  878.         remaining  bootstrap  (bootas,    bootwd)    are
  879.         invoked    by  install,  which  in  turn    load
  880.         386BSD itself.
  881.  
  882. The baseutils.cpio.Z file
  883.  
  884.      The baseutils.cpio.Z file in the /etc  directory  is  a
  885. compressed  file  containing  all  the    necessary  utilities
  886. required after the install command is run. It  contains    all
  887. facilities  for downloading and completing the extraction of
  888. 386BSD Release 0.1. Since these items cannot be run on    this
  889. floppy,    they  have  been compressed to save space. When the
  890. base system is installed on the hard disk, these  facilities
  891. are uncompressed and ready-for-use.
  892.  
  893.      To see a table-of-contents listing of what is contained
  894. within this file, type:
  895.  
  896.     zcpio -itv < baseutils.cpio.Z
  897.  
  898. Some key items of interest include:
  899.  
  900. /        The extract utility, used only for  validat-
  901.         ing  and  extracting the release on the hard
  902.         disk.
  903.  
  904. /bin        chmod changes the  mode    (read-write-execute
  905.         permissions) of a file.
  906.  
  907. /etc        Configuration files used for network  opera-
  908.         tion;  protocols  and  services.   protocols
  909.         determines which protocol is associated with
  910.         with  the  number  in  the  internet  packet
  911.         header (used by ftp).  services contains the
  912.         binding    for  well-known name services (also
  913.         used by ftp).
  914.  
  915.  
  916.  
  917. 386BSD INSTALLATION NOTES    14    Copyright (C) 1992 TeleMuse
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925. July 1992                    Release 0.1
  926.  
  927.  
  928. /sbin        slattach associates a serial port  (COM1  or
  929.         COM2)  with  a SLIP packet driver (i.e. sl0)
  930.         built into the system,    turning    it  into  a
  931.         link-level interface to another system (i.e.
  932.         slattach com1 2400 <a baud rate>).  ifconfig
  933.         initializes  a    network    level    address to a
  934.         packet device For SLIP, both source and des-
  935.         tination  must    be specified for a point-to-
  936.         point  connection.   (i.e.    ifconfig    sl0
  937.         192.108.246.100    192.108.246.200,  ifconfig
  938.         we0 192.108.246.40).  route manipulates    the
  939.         routing    table    (i.e.    route    add  default
  940.         192.108.245.11).
  941.  
  942. /usr/bin    ftp (file  transfer  protocol)    is  used  to
  943.         retrieve the distribution via the network.
  944.  
  945. /usr/distbin    mknod creates device  files  for  communica-
  946.         tions. sync forces an immediate write to the
  947.         disk.  tip is used to connect via a modem to
  948.         a remote system (i.e.  tip /dev/com1).
  949.  
  950. usr/local/bin    Versions of rz (receive ZMODEM protocol com-
  951.         mand)  and  mread  (part  of the mtools set;
  952.         reads a MS-DOS floppy).    The  mread  command
  953.         should    never  be  run    off of the floppy --
  954.         only off the hard disk    (after    the  install
  955.         procedure).
  956.  
  957. /usr/sbin    update syncs out filesystem every 30 seconds
  958.         automatically.    bad144    maps out bad sectors
  959.         on the disk.  See "Bad Sector  Mapping"    for
  960.         more information.
  961.  
  962. 386BSD Installation Procedures
  963.  
  964.      Now that you have had a tour of the Tiny 386BSD floppy,
  965. you  can  embark on the installation procedures for the rest
  966. of the system.    We have considerably simplified    the  386BSD
  967. installation  procedures  since the previous release, so you
  968. can get underway more quickly.    However, if you feel  uncom-
  969. fortable  with    the  procedures    outlined below, please look
  970. before you leap and ask your local PC-UNIX user group, elec-
  971. tronic    discussion  forum,  or    newsgroup for help. Already,
  972. there are people with experience on more  machines  than  we
  973. can list.  Leverage other people's knowledge and experience,
  974. but don't forget to share yours as well. That's    how  386BSD
  975. gets better.
  976.  
  977.      While 386BSD does not require MS-DOS to run, it can now
  978. coexist with MS-DOS on the same disk in a separate partition
  979. (although you can also use the entire disk if  you  prefer).
  980. In  any    case, IF YOU WISH TO SAVE THE CONTENTS ON YOUR DISK
  981.  
  982.  
  983. 386BSD INSTALLATION NOTES    15    Copyright (C) 1992 TeleMuse
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991. July 1992                    Release 0.1
  992.  
  993.  
  994. FOR LATER USE, YOU MUST MAKE A    BACKUP.    (This    is  true  no
  995. matter    what system is used).  You should also make a backup
  996. copy of the system and several copies of Tiny 386BSD and the
  997. Fix-It    floppy and save them away.  You should always have a
  998. working spare if system recovery procedures ever have to  be
  999. implemented.
  1000.  
  1001. Resizing MS-DOS and Creating a Partition
  1002.  
  1003.      Typically, a PC is purchased with MS-DOS on the  entire
  1004. drive.    If  you  would like MS-DOS to remain on the system,
  1005. you must first reduce the MS-DOS partition size so that free
  1006. space will be made available to 386BSD.
  1007.  
  1008.      NOTE: If you intend to use the entire drive for 386BSD,
  1009. you  can  ignore  the  following  steps    and  proceed to the
  1010. install procedure. If you intend to install the system manu-
  1011. ally,  using  disklabel,  newfs, etc., you must obtain these
  1012. utilities from the "Fix-It" floppy and follow  standard    BSD
  1013. installation  procedures as documented in BSD administration
  1014. references. Manual installation    procedures  are  no  longer
  1015. discussed in these notes.
  1016.  
  1017.      First, backup any files you wish to save. MS-DOS stores
  1018. information  randomly  all  over  the partition, so you will
  1019. destroy your files if you  resize.  Then  grab    your  MS-DOS
  1020. floppy and boot it up.
  1021.  
  1022.      Next, using the MS-DOS fdisk command,  delete  the    old
  1023. partition,  create  a new smaller partition (saving at least
  1024. 40 MBytes for 386BSD), and make it active.  Then,  you    must
  1025. high-level  format  the    disk,    using the MS-DOS format c:/s
  1026. command. Finally, you must copy MS-DOS back into this parti-
  1027. tion  from  the floppy, restoring any backup files.  You are
  1028. now ready to install 386BSD.
  1029.  
  1030.      If you are already using a fancy  partitioning  program
  1031. such as "diskmanager", you should setup the 386BSD partition
  1032. as type 0xa5 (decimal 165), with a minimum partition size of
  1033. 40 MBytes to load and run the binary distribution set.    (The
  1034. complete source, binary, and other distribution sets are 120
  1035. MBytes    uncompressed  and hence require at least a 200 MByte
  1036. drive if you want to recompile the system and use the larger
  1037. source/binary  public  packages.)  The    install program will
  1038. then  detect  this  dedicated  partition  and  automatically
  1039. install    386BSD    within    it.   THIS  IS INTENDED FOR SPECIAL
  1040. APPLICATIONS, AND IS NOT INTENDED AS THE GENERAL PURPOSE WAY
  1041. TO BRING UP 386BSD.
  1042.  
  1043. Installing the 386BSD Base System
  1044.  
  1045.      Next, boot up the Tiny 386BSD distribution installation
  1046. floppy and type
  1047.  
  1048.  
  1049. 386BSD INSTALLATION NOTES    16    Copyright (C) 1992 TeleMuse
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057. July 1992                    Release 0.1
  1058.  
  1059.  
  1060.     install
  1061.  
  1062. It will first query you as to how much    space  you  wish  to
  1063. allocate  to 386BSD.  You should allocate at least 40 MBytes
  1064. for the binary distribution.
  1065.  
  1066.      Once you have determined how much    space  you  wish  to
  1067. dedicate  to  386BSD,  it  will then query if you wish it to
  1068. create a 386BSD partition. If you  say    no,  it    will  query
  1069. whether you want to place 386BSD on the entire drive. (Warn-
  1070. ing: putting 386BSD on the entire  drive  will    destroy    all
  1071. data currently on the disk.)
  1072.  
  1073.      Once you agree to either creating a new  386BSD  parti-
  1074. tion  (if  you did not create a 386BSD partition earlier) or
  1075. putting it on the entire disk, a bootable image of the    dis-
  1076. tribution  installation floppy will be installed. The system
  1077. will then reboot and continue operation on  the    hard  disk,
  1078. freeing    up  the floppy for installation of the remainder of
  1079. the distribution (if desired).
  1080.  
  1081.      If you wish to resize the partition after    install    has
  1082. been  run (but before continuing further), simply go back to
  1083. MS-DOS (5.0 and later) and run the fdisk  utility  again  to
  1084. delete the old 386BSD partition. Then, return to Tiny 386BSD
  1085. and run install again.
  1086.  
  1087.      If you wish to install  386BSD  over  the    entire    disk
  1088. after  install has been run (but before continuing further),
  1089. simply run install again.
  1090.  
  1091.      If you wish to deinstall 386BSD after installation,  go
  1092. back  to  MS-DOS  (5.0    and later) and run the fdisk utility
  1093. again to delete the partition.
  1094.  
  1095.      To switch bootable systems (say, 386BSD to MS-DOS), use
  1096. either a partition switcher bootstrap, the MS-DOS fdisk com-
  1097. mand to make the partition active, or the  shutdown  command
  1098. (see  "Files  of  Tiny    386BSD"    for more information on the
  1099. shutdown command).
  1100.  
  1101.      To erase 386BSD from the dedicated disk, simply  refor-
  1102. mat  the  system. Some versions of MS-DOS require the master
  1103. boot record to be rewritten as well, using the MS-DOS "fdisk
  1104. /mbr" command.
  1105.  
  1106.      Other versions of MS-DOS require that the    boot  record
  1107. lose  its  validity before being rewritten by fdisk. This is
  1108. accomplished by cat'ing a file to the "raw" partition 'd' of
  1109. the  drive, "cat /386bsd >/dev/rwd0d", and then reformatting
  1110. under MS-DOS.  If you are using an old    version    of  MS-DOS,
  1111. you can use this technique to delete the 386BSD partition as
  1112. well. This technique usually works (not always, however). As
  1113.  
  1114.  
  1115. 386BSD INSTALLATION NOTES    17    Copyright (C) 1992 TeleMuse
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123. July 1992                    Release 0.1
  1124.  
  1125.  
  1126. such,  we strongly recommend that you obtain the most up-to-
  1127. date version of MS-DOS (5.0 or better) and save yourself the
  1128. headache.
  1129.  
  1130. Bad Sector Mapping
  1131.  
  1132.      Sometimes, during the installation procedure, bad    sec-
  1133. tors are found on a ST-506 (MFM), RLL, or ESDI drive:
  1134.  
  1135.     "wd0: hard read error writing fsbn XXXXX (wd0 bn YYYYY; cn ZZZ, tn A, sn B)
  1136.  
  1137. This message indicates that it is a wise idea to map out bad
  1138. sectors before continuing further, using the bad144 utility.
  1139. To initialize, type:
  1140.  
  1141.     bad144 wd0 0
  1142.  
  1143. To map out a bad sector (the "bn" number YYYYY cited  above)
  1144. found by install, type:
  1145.  
  1146.     bad144 -a wd0 YYYYY
  1147.  
  1148.  
  1149.      WARNING: bad144 is NEVER used with SCSI or    IDE  disks,
  1150. since  they  have  their  own  bad sector mapping functions.
  1151. Since ESDI and IDE drives appear  very    similar,  make    sure
  1152. before    running this command that you have an ESDI drive and
  1153. not an IDE drive.  SCSI and IDE    drives    should    never    have
  1154. "hard  read error" messages.  If you get these messages, the
  1155. drive may be  misconfigured,  or  you  may  require  special
  1156. assistance.
  1157.  
  1158. Loading the 386BSD Binary Distribution
  1159.  
  1160.      Now that you have the 386BSD base system running on the
  1161. hard  disk,  you  can  download the rest of the distribution
  1162. sets, and then extract and install them.  Each    distribution
  1163. set consists of a multivolume, compressed, CPIO format dump.
  1164. All files must be present before extraction, and after    suc-
  1165. cessful extraction they should be removed to reclaim space.
  1166.  
  1167.      The distribution media range  from    floppies,  3M    data
  1168. cartridge  tapes,  8MM Exabyte tape, to CDROM. You can down-
  1169. load the distribution via the INTERNET network (via Ethernet
  1170. or SLIP), or by using serial download using ZMODEM from ser-
  1171. vices like M&T Online, Compuserve,  and    BIX.  (Please    note
  1172. that  the  instructions    for downloading from Internet sites
  1173. assumes familiarity with the use of ftp)
  1174.  
  1175.      The complete distribution (binary,    source,  and  addi-
  1176. tional    packages)  is  very  large  (greater  than 40 MBytes
  1177. compressed), so you should obtain it in    increments  (binary
  1178. first,    then source, then additional packages) and only from
  1179.  
  1180.  
  1181. 386BSD INSTALLATION NOTES    18    Copyright (C) 1992 TeleMuse
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189. July 1992                    Release 0.1
  1190.  
  1191.  
  1192. a large bandwidth network or a    dense  distribution  medium.
  1193. (The  size and growth rate of 386BSD is bringing the spector
  1194. of 100+ compressed floppy dumps closer every day).
  1195.  
  1196. A. Loading the System From Floppies
  1197.     To load the 386BSD binary distribution, first change  to
  1198.     the /tmp directory, where the files will be held. Type
  1199.  
  1200.     cd /tmp
  1201.  
  1202.     Now you are ready to download the distribution.
  1203.  
  1204.     To load the a set of 386BSD    binary    distribution  flop-
  1205.     pies,  insert one of the floppies in drive unit A (or 0)
  1206.     and type:
  1207.  
  1208.     loadfd
  1209.  
  1210.     Insert others until the entire distribution    is  loaded.
  1211.     Hit    a  CNTRL-C when all the floppies are loaded.  (Dis-
  1212.     tribution floppies are kept in  MS-DOS  format  floppies
  1213.     for    ease of disk replication and the convenience of the
  1214.     PC user).
  1215.  
  1216.     The floppies can be loaded in any order.   If  an  error
  1217.     occurs  during loading (such as a bad spot on a floppy),
  1218.     only the floppy with the error  need  be  reloaded    (not
  1219.     necessarily    from  the  same  source). For example, if a
  1220.     single file fails to load from a floppy, that floppy can
  1221.     be    obtained  via  serial  download    over a modem or the
  1222.     INTERNET network. You can then reload it by typing:
  1223.  
  1224.     mread "a:*.*" .
  1225.  
  1226.  
  1227. B. Loading the System From Tape
  1228.     To load the 386BSD binary distribution from 3M cartridge
  1229.     tape,  insert  a QIC Cartridge (or 8mm tape) in the tape
  1230.     drive interfaced to either SCSI or QIC-02 (no QIC-40  or
  1231.     QIC-80  supported  at this time).  For a SCSI-interfaced
  1232.     tape  drive,  select  the  appropriate   target   device
  1233.     corresponding to the tape drive (example: target 2. dev-
  1234.     ice /dev/ras2a).  Then type the command:
  1235.  
  1236.     cpio -iadm < /dev/ras2a
  1237.  
  1238.     For QIC-02 tape drives,  select  device  /dev/rwt0,    and
  1239.     type:
  1240.  
  1241.     cpio -iadm < /dev/rwt0
  1242.  
  1243.     In each case the files will be read in as with the flop-
  1244.     pies.  If  any  of    the  files  read in off the tape are
  1245.  
  1246.  
  1247. 386BSD INSTALLATION NOTES    19    Copyright (C) 1992 TeleMuse
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255. July 1992                    Release 0.1
  1256.  
  1257.  
  1258.     corrupted or did not load correctly, extract will refuse
  1259.     to    work  until  you  correct the problem, possibly by a
  1260.     serial download of the affected  file  later,  or  by  a
  1261.     floppy containing the affected file.
  1262.  
  1263. C. Loading the System From CDROM
  1264.     To load the 386BSD binary distribution from SCSI  CDROM,
  1265.     insert  a  ISO-9660 CDROM into the SCSI drive, and mount
  1266.     the CDROM by selecting  the    appropriate  target  device
  1267.     (example target 6 is /dev/as6c):
  1268.  
  1269.     mount -i /dev/as6c /mnt
  1270.  
  1271.     Then, locate the 386BSD release  directory    and  execute
  1272.     the    extract program from that directory.  (Refer to the
  1273.     CDROM installation instructions for more information.)
  1274.  
  1275. D. Loading the System via SLIP (Serial Line IP)
  1276.  
  1277.      To load the 386BSD binary distribution via a SLIP    con-
  1278. nection,  attach  a SLIP connection to the COM1 serial port.
  1279. Use the slattach program at the desired baud rate to  create
  1280. a  link    layer connection to 386BSD and then enable the net-
  1281. work layer with the ifconfig program (for example):
  1282.  
  1283.     slattach /dev/com1 2400
  1284.     ifconfig sl0 <386bsd hostnumber> <system connected to hostnumber>
  1285.  
  1286. Use the route command to install the default  route  to    the
  1287. local gateway if you wish to download from one of the master
  1288. distribution hosts on the INTERNET.  (Note that you can only
  1289. use  numeric  (e.g.  192.108.24.5)  network  addresses,    not
  1290. names).
  1291.  
  1292.     route add default <local gateway number>
  1293.  
  1294. Then use the ftp utility to copy files down from a distribu-
  1295. tion  host,  using  binary mode ("bin")    and the "mget" com-
  1296. mand.
  1297.  
  1298.     ftp <distribution hostnumber>
  1299.  
  1300.  
  1301. D. Loading the System via Ethernet
  1302.     To load the 386BSD binary distribution via    an  Ethernet
  1303.     connection,    attach    the  Ethernet    to  a local network.
  1304.     (Note, if the system does not find the Ethernet card  in
  1305.     the    bootstrap manifest, this will not work). Enable the
  1306.     network (ifconfig <enet device> <386bsdhost>), and    then
  1307.     follow  the    same procedures for ftp and routing as used
  1308.     in SLIP downloading.
  1309.  
  1310.  
  1311.  
  1312. 386BSD INSTALLATION NOTES    20    Copyright (C) 1992 TeleMuse
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320. July 1992                    Release 0.1
  1321.  
  1322.  
  1323. D. Loading the System via Modem
  1324.     To download the 386BSD  binary  distribution  from    Com-
  1325.     puserve  or    BBS services which feature serial download-
  1326.     ing, attach a modem to  COM1.  Using  the  tip  program,
  1327.     type:
  1328.  
  1329.     tip com1<CR>            (begin tip session via com1)
  1330.     ~CNTL-Z            (suspend tip program)
  1331.  
  1332.     You should now have    back  your  "#"  prompt.   Set    the
  1333.     appropriate    baud  rate  and  other    parameters for your
  1334.     modem, using the stty command and then  fg    (foreground)
  1335.     back to your serial session:
  1336.  
  1337.     stty 2400 </dev/com1    (set the baud rate on com1 to 2400)
  1338.     fg            (go back to tip)
  1339.  
  1340.     Use tip to communicate with the modem, by  using  it  to
  1341.     dial and connect to a remote host and login:
  1342.  
  1343.     tip com1            (back to session)
  1344.     ATDT 0005551212<CR>    (type in phone number of remote host)
  1345.  
  1346.     CONNECTED
  1347.  
  1348.     Your remote system site banner message and login procedures
  1349.  
  1350.     Once you login to your download site, intitiate a ZMODEM
  1351.     file  download.  Then suspend tip as before to return to
  1352.     your host, and use the  rz    program    to  receive  ZMODEM
  1353.     files that are pending on the wire.
  1354.  
  1355.     rz </dev/com1 >/dev/com1
  1356.  
  1357.     After downloading is completed, tip can be "unsuspended"
  1358.     to    logoff    the  remote  system, and break connection by
  1359.     hanging up the modem:
  1360.  
  1361.     +++            (get the modem's attention)
  1362.     OK
  1363.     ATH0<CR>        (hang up the line)
  1364.     OK
  1365.     ~.<CR>            (terminate tip session)
  1366.  
  1367.  
  1368.      Once a distribution set is loaded into the /tmp  direc-
  1369. tory  by  any  of these mechanisms, it can then be extracted
  1370. and loaded on the hard disk.
  1371.  
  1372. Extracting and Loading the 386BSD Binary on the Disk
  1373.  
  1374.      Once the files are in place in the /tmp directory,    the
  1375. extract    command  is  run.  This  command  specifies  which
  1376.  
  1377.  
  1378. 386BSD INSTALLATION NOTES    21    Copyright (C) 1992 TeleMuse
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386. July 1992                    Release 0.1
  1387.  
  1388.  
  1389. distribution set is being extracted: binary (bin01),  source
  1390. (src01), or the additional software set (etc01).
  1391.  
  1392.     extract <distsetname>
  1393.  
  1394. For example, the command
  1395.  
  1396.     extract bin01
  1397.  
  1398. first checks the binary files. If all the  elements  of    the
  1399. set are present and verified, it then extracts and loads the
  1400. final system onto  the    hard  disk.  DO    NOT  INTERRUPT    THE
  1401. EXTRACT PROCEDURE ONCE IT HAS BEGUN.
  1402.  
  1403.      If extract finds files missing or    corrupted,  it    will
  1404. list the problem files:
  1405.  
  1406.     "File bin01.XX is corrupt"
  1407.     "File bin01.YY is missing"
  1408.  
  1409. stop the extraction procedure, and return with a "#" prompt.
  1410. If  you    wish to stop your work at this point of the extrac-
  1411. tion procedure to retrieve new copies of the problem  files,
  1412. you  can  use  the  shutdown command to safely shut down the
  1413. system, saving your work. Once you reload the missing  files
  1414. (via  any  of  the  methods outlined above), run the extract
  1415. command again.
  1416.  
  1417.      If the set is complete and valid, extract announces  it
  1418. is  extracting    the  distribution,  extracts  the files, and
  1419. loads them into final position. This procedure takes approx-
  1420. imately 15-20 minutes.    ONCE THE EXTRACT PROCEDURE IS BEGUN,
  1421. IT MUST NOT  BE    INTERRUPTED  OR  BAD  THINGS  WILL  HAPPEN!
  1422. REALLY!    DO  NOT  INTERRUPT  HAPPY  EXTRACT COMMAND. DO NOT
  1423. TAUNT HAPPY EXTRACT COMMAND.
  1424.  
  1425.      Should the impossible happen and  you  trip  over    your
  1426. power  cord  (for  example)  while  the    extract  command is
  1427. extracting the system on the hard disk, boot the Tiny 386BSD
  1428. Installation  floppy  and  start  the installation procedure
  1429. over from the beginning. We do    not  advise  attempting    BSD
  1430. system    recovery procedures at this point, as the filesystem
  1431. may be inconsistent.
  1432.  
  1433.      At the end    of  the  extract  procedure,  you  will  be
  1434. prompted  for  your  computer  system  name.  If  you have a
  1435. fully-qualified Internet domain name assigned  to  your    PC,
  1436. you must type it here. If you do not have an Internet domain
  1437. name (the common case), type a name which you wish  to    call
  1438. your computer (i.e. "havoc", "daisy", "gremlin", etc. -- the
  1439. name is only limited by your imagination).
  1440.  
  1441.  
  1442.  
  1443. 386BSD INSTALLATION NOTES    22    Copyright (C) 1992 TeleMuse
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451. July 1992                    Release 0.1
  1452.  
  1453.  
  1454.      When the extraction process is complete,  it  will    say
  1455. "extraction  successful"  and  return with a "#" prompt.  At
  1456. this point, you may also download  and    extract    the  source
  1457. and/or other software distribution sets (src01, etc01). How-
  1458. ever, please be aware that these sets  are  very  large    and
  1459. require    an  additional    200-300 MBytes to recompile and use
  1460. comfortably.
  1461.  
  1462.      Once you have  completed  the  extraction    process    and
  1463. obtained  the  distribution sets you desire, you can now run
  1464. the complete 386BSD Release 0.1 binary system  off  of    your
  1465. hard disk. Type
  1466.  
  1467.     shutdown
  1468.  
  1469. Note: once you reboot the system, anything saved in /tmp  is
  1470. wiped away. To save any files, you must save them in another
  1471. directory or off the disk to other media.
  1472.  
  1473.      Congratulations! You now have a complete 386BSD  binary
  1474. release. Login as "root" and get to work!
  1475.  
  1476.      Now that we've gotten through all this, please remember
  1477. to join the 386BSD User Community and send us your REGISTRA-
  1478. TION form!
  1479.  
  1480. DES Encryption
  1481.  
  1482.      386BSD incorporates software (such as  NFS)  which    has
  1483. been  done  by    researchers  in other countries. As a conse-
  1484. quence, DES encryption and Kerberos have purposely been left
  1485. off all 386BSD releases to allow for international use. This
  1486. precludes password encryption for accounts.  386BSD is not a
  1487. secure    system,    and should not be used as configured when a
  1488. secure system is required.
  1489.  
  1490. A Personal Perspective
  1491.  
  1492.      Life often goes in cycles, so they say. Ten years or so
  1493. ago,  another  system  developed Bill (also unfunded, by the
  1494. way) went out the door -- the 2.8 BSD release for  the    PDP-
  1495. 11.   (At  that    time, the PDP-11 was the "inexpensive" com-
  1496. puter of choice for universities and research groups).    2.8
  1497. BSD  was  the first complete BSD operating system and utili-
  1498. ties release for the PDP-11, and  it  was  very    successful.
  1499. However,  the  PDP-11 architecture was eventually superceded
  1500. by other faster machines such as the VAX.
  1501.  
  1502.      By choosing such a popular platform as the 386/486    PC,
  1503. we  had hoped that 386BSD would go even further than 2.8 BSD
  1504. ever could.  We have already seen how a "populist" system on
  1505. an  inexpensive platform could excite interest and new work,
  1506. and we hoped  that  386BSD  would  reignite  a    new  era  of
  1507.  
  1508.  
  1509. 386BSD INSTALLATION NOTES    23    Copyright (C) 1992 TeleMuse
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517. July 1992                    Release 0.1
  1518.  
  1519.  
  1520. innovation.
  1521.  
  1522.      As we look back over the last two decades, we  feel  it
  1523. is  important  to  remind everyone of some of the history of
  1524. BSD development, so you can understand why we feel that mak-
  1525. ing  386BSD available and accessible, and evolving it in new
  1526. directions, is so very important. Perhaps Dennis Ritchie and
  1527. Ken  Thompson  expressed  it  best when they discussed their
  1528. perspective on UNIX in    their  now-classic  The    UNIX  Time-
  1529. Sharing    System    paper    presented  to the ACM in 1974. It is
  1530. perhaps fitting that words written over 18 years ago by    the
  1531. Developers  of    UNIX  should  still  be relevant to us using
  1532. 386BSD today:
  1533.  
  1534.     Perhaps paradoxically, the success of the UNIX  sys-
  1535.     tem    is  largely  due  to  the  fact that it was not
  1536.     designed to    meet  any  predefined    objectives.  The
  1537.     first version was written when one of us (Thompson),
  1538.     dissatisfied with the available computer facilities,
  1539.     discovered a little-used PDP-7 and set out to create
  1540.     a more  hospitable    environment.  This  (essentially
  1541.     personal) effort was sufficiently successful to gain
  1542.     the interest of the other author  and  several  col-
  1543.     leagues, and later to justify the acquisition of the
  1544.     PDP-11/20, specifically to support    a  text    editing
  1545.     and    formatting  system.  When in turn the 11/20 was
  1546.     outgrown, the system had  proved  useful  enough  to
  1547.     persuade  management to invest in the PDP-11/45, and
  1548.     later in the PDP-11/70 and Interdata 8/32  machines,
  1549.     upon  which    it  developed to its present form.  Our
  1550.     goals throughout this effort,  when    articulated  at
  1551.     all,  have    always been to build a comfortable rela-
  1552.     tionship with the machine and to explore  ideas  and
  1553.     inventions    in operating systems and other software.
  1554.     We have not been faced with    the  needs  to    satisfy
  1555.     someone else's requirements, and for this freedom we
  1556.     are thankful.
  1557.  
  1558. We hope that the existence and growth of 386BSD    will  quash
  1559. the  cynical  notion,  cultivated over the last decade, that
  1560. the individual is irrelevant to progress. That was, and    has
  1561. always been, nonsense.    It is only through the creativity of
  1562. unencumbered minds that new ideas will develop and flourish.
  1563.  
  1564.      We realize that Release 0.1 still has far to  go.    How-
  1565. ever,  we  are    very  proud  of what we, with the aid of our
  1566. dedicated user base, have accomplished so far.
  1567.  
  1568. The Future of 386BSD: It's up to You
  1569.  
  1570.      386BSD Release 0.0 has met with  tremendous  enthusiasm
  1571. and  support,  and we hope that 386BSD Release 0.1, a stable
  1572. robust version of 386BSD with enhanced    functionality,    will
  1573.  
  1574.  
  1575. 386BSD INSTALLATION NOTES    24    Copyright (C) 1992 TeleMuse
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583. July 1992                    Release 0.1
  1584.  
  1585.  
  1586. allow more people to try 386BSD.
  1587.  
  1588.      But ironically, the very success of 386BSD has made  it
  1589. impossible  for    us to continue doing out-of-pocket personal
  1590. releases.  Complete  releases  such  as    we  are  doing    are
  1591. demanding,  time-consuming,  and expensive. It has been most
  1592. frustrating to us that    while  the  vision,  the  will,    the
  1593. experience,  and the leadership are all present, the practi-
  1594. cal constraints have become too great for us to ignore.
  1595.  
  1596.      Over the course of these  releases,  many    people    have
  1597. become    confused as to what 386BSD actually is.    As such, we
  1598. feel  is  important  to    underscore  the  basic    differences
  1599. between    a commercial release and a research release such as
  1600. 386BSD.    While    both  are  extremely  costly   to   develop,
  1601. engineer,  and    release,  they    actually have very different
  1602. agendas.
  1603.  
  1604.      Commercial    releases  efforts  are    defined  by   well-
  1605. established  customer  demands,    prior product releases, and
  1606. (occasionally) strategic marketing directions. In  addition,
  1607. if  something  needs  to  be added, it can be "tossed in" to
  1608. satisfy immediate needs (the old "give the customer what  he
  1609. thinks    he  wants" mentality). Long-term objectives are gen-
  1610. erally given short shrift.
  1611.  
  1612.      Unlike commercial releases, releases  targeted  to    the
  1613. research and educational communities are much more demanding
  1614. in that the developer must possess a broad understanding  of
  1615. long-term  technological  trends  and  objectives and incor-
  1616. porate them into each release, while still maintaining func-
  1617. tionality.  As a consequence, research releases and new work
  1618. are generally done only under  the  appropriate    supervision
  1619. and auspices of a well-funded University project.
  1620.  
  1621.      However, we have discovered that any group selected  to
  1622. shape  these  releases    must demonstrate leadership, vision,
  1623. good judgment, and a devotion to  ethical  behavior  in    all
  1624. their  dealings.  A  development  group chosen merely on the
  1625. basis of convenience and cynicism (i.e. a "political"  solu-
  1626. tion)  will  result  in    the  immediate desecration of these
  1627. goals.
  1628.  
  1629.      If new research directions are to be fully explored and
  1630. developed  using  386BSD,  then    386BSD    itself must evolve.
  1631. These first two releases, historic though they may  be,    are
  1632. just  the beginning of this process, and not an end in them-
  1633. selves.
  1634.  
  1635.      Over the course of our 386BSD series in  DDJ,  we    have
  1636. occasionally  touched upon many areas of new technology with
  1637. which 386BSD and other UNIX-like operating systems must con-
  1638. tend,    such   as   symmetric    multiprocessing,  multimedia
  1639.  
  1640.  
  1641. 386BSD INSTALLATION NOTES    25    Copyright (C) 1992 TeleMuse
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649. July 1992                    Release 0.1
  1650.  
  1651.  
  1652. applications, and gigabit networks. We are  fully  aware  of
  1653. how to focus 386BSD to head in these directions, and we have
  1654. spoken to many others in the research community who want  to
  1655. work on and share in this vision.
  1656.  
  1657.      However, if the benefits which 386BSD offers are to  be
  1658. "claimed"  by the entire research and educational community,
  1659. the costs must be borne by all of us as well.
  1660.  
  1661.      Quite frankly, if 386BSD is to have any future, it will
  1662. require    considerable  resources  and assistance, as well as
  1663. the continued goodwill and enthusiasm of its user base. Your
  1664. interest,  involvement,    and support of 386BSD and its goals
  1665. will ultimately determine the future of 386BSD    and  succes-
  1666. sive releases.
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706. 386BSD INSTALLATION NOTES    26    Copyright (C) 1992 TeleMuse
  1707.  
  1708.  
  1709.  
  1710.